Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BREAKING: connection.ini: replaces ... #3435

Merged
merged 2 commits into from
Jan 30, 2025
Merged

BREAKING: connection.ini: replaces ... #3435

merged 2 commits into from
Jan 30, 2025

Conversation

msimerson
Copy link
Member

@msimerson msimerson commented Jan 20, 2025

BREAKING CHANGE

connection.ini replaces the following config files:

old file connection.ini setting
haproxy_hosts [haproxy] hosts
smtpgreeting [message] greeting
ehlo_hello_message [message] helo
connection_close_message [message] close
banner_includes_uuid [uuid] banner_chars
deny_includes_uuid [uuid] deny_chars
databytes [max] bytes
max_mime_parts [max] mime_parts
max_line_length [max] line_length
max_data_line_length [max] data_line_length

AND

  • moves the following settings from smtp.ini to connection.ini:
    • headers.*
    • main.smtp_utf8
    • main.strict_rfc1869
  • early_talker.pause, removed support, use earlytalker.ini

To upgrade, apply any localized settings from the old config files to the new connection.ini file. For tidiness, delete the deprecated config files.

Fixes #3434

Checklist:

  • docs updated
  • tests updated
  • Changes updated

Commentary

This is a bit of a break from tradition in that Haraka has historically been loathe to ever deprecate a config file. We've jumped through hoops to assure that old config files remained working unless we bumped a major version, which also meant legacy config files were almost never dropped.

This state of affairs has been bad for discoverability as well as having documentation (when existent) for the settings scattered about. This PR consolidates a bunch of settings that are only ever used within a connection, moves the documentation for the settings into the config file next to the knobs that can be twiddled, deprecates the necessity of passing smtp.ini into connections, and improves the consistency of the implementations.

haproxy_hosts, ehlo_hello_message, connection_close_message, banner_includes_uuid, deny_includes_uuid, databytes, max_mime_parts, max_line_length, max_data_line_length, and smtpgreeting.

To upgrade, apply any localized settings from the old config files to the new connection.ini file and for tidiness, delete the old config files.

- moved the following settings from smtp.ini to connection.ini:
  - headers.*
  - main.smtp_utf8
  - main.strict_rfc1869
- early_talker.pause, removed support, use earlytalker.ini
@msimerson msimerson changed the title connection.ini: replaces ... BREAKING: connection.ini: replaces ... Jan 21, 2025
@msimerson msimerson marked this pull request as ready for review January 21, 2025 01:08
@msimerson msimerson merged commit 78d96d7 into master Jan 30, 2025
19 checks passed
@msimerson msimerson deleted the connection.ini branch January 30, 2025 18:28
@msimerson msimerson mentioned this pull request Jan 30, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

ehlo_hello_message missing from doc page
1 participant